/**
 * Copyright (c) 2011 eelpo.com
 * All rights reserved.
 */
package com.eelpo.cmmp.uac.services;

import java.util.List;

import com.eelpo.cmmp.core.exception.ServiceException;
import com.eelpo.cmmp.uac.dao.vo.EntityType;

/**
 * <pre>
 * 
 * 实体类型管理服务接口定义
 * 
 * </pre>
 * 
 * @author <a href="mailto:Brian@eelpo.com">汪洪州</a>
 * @since 1.0
 */
public interface IEntityTypeManageService {

	/**
	 * 根据实体类型Id获取实体类型对象
	 * 
	 * @param id
	 *            实体类型ID
	 * @return 返回实体类型值对象
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public EntityType getEntityTypeById(String id) throws ServiceException;

	/**
	 * 根据实体类型code获取实体类型对象
	 * 
	 * @param code
	 *            实体类型code值
	 * @return 返回实体类型值对象
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public EntityType getEntityTypeByCode(String code) throws ServiceException;

	/**
	 * 检查实体类型code是否已经存在
	 * 
	 * @param code
	 *            实体类型code值
	 * @return 返回布尔值，true表示已经存在，false表示不存在
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public boolean checkExist(String code) throws ServiceException;

	/**
	 * 新增实体类型
	 * 
	 * @param entityType
	 *            实体类型对象
	 * @return 返回新增过的实体类型ID
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public String addEntityType(EntityType entityType) throws ServiceException;

	/**
	 * 修改实体类型
	 * 
	 * @param entityType
	 *            实体类型对象
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public void updateEntityType(EntityType entityType) throws ServiceException;

	/**
	 * 禁用实体类型
	 * 
	 * @param entityType
	 *            实体类型对象
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public void disabledEntityType(EntityType entityType) throws ServiceException;

	/**
	 * 启用实体类型
	 * 
	 * @param entityType
	 *            实体类型对象
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public void enabledEntityType(EntityType entityType) throws ServiceException;

	/**
	 * 根据Id删除实体类型
	 * 
	 * @param entityType
	 *            实体类型对象
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public void deleteEntityType(EntityType entityType) throws ServiceException;

	/**
	 * 根据参数获取实体类型分页列表
	 * 
	 * @param entityType
	 *            实体类型参数
	 * @param first
	 *            分页起始条数
	 * @param max
	 *            分页获取的单页条数
	 * @return 返回实体类型分页列表
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public List<EntityType> getEntityTypesPaing(EntityType entityType, final int first, final int max) throws ServiceException;

	/**
	 * 根据参数获取实体类型数量
	 * 
	 * @param entityType
	 *            实体类型参数
	 * @return 返回实体类型数量
	 * @throws ServiceException
	 *             抛出服务层业务异常
	 */
	public int getEntityTypesCount(EntityType entityType) throws ServiceException;
}
